home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat2 / standard / setash.z / setash
Encoding:
Text File  |  2001-04-17  |  3.0 KB  |  67 lines
  1.  
  2.  
  3.  
  4. sssseeeettttaaaasssshhhh((((2222))))                                                            sssseeeettttaaaasssshhhh((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      setash - set array session handle
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<uuuunnnniiiissssttttdddd....hhhh>>>>
  14.  
  15.      ####iiiinnnntttt sssseeeettttaaaasssshhhh((((aaaasssshhhh____tttt aaaasssshhhh))));;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      The _s_e_t_a_s_h function changes the handle for the array session containing
  19.      the current process to the value specified by _a_s_h.  The current process
  20.      must have superuser privileges to invoke _s_e_t_a_s_h.
  21.  
  22.      Ordinarily, a handle that is unique within the current system is assigned
  23.      to an array session when the array session is created using the
  24.      _n_e_w_a_r_r_a_y_s_e_s_s(2) function.  The _s_e_t_a_s_h function can be used to override
  25.      this default handle, perhaps for assigning a handle that is unique across
  26.      an entire array or for synchronizing handles with an array session on
  27.      another system.
  28.  
  29.      The handle specified by _a_s_h must be a positive value, must not be in use
  30.      on the current system, and must not be in the range of values that IRIX
  31.      uses for default array session handles.  This range of default handles is
  32.      defined by the system variables mmmmiiiinnnn____llllooooccccaaaallll____ppppaaaaggggggggiiiidddd and mmmmaaaaxxxx____llllooooccccaaaallll____ppppaaaaggggggggiiiidddd and
  33.      can be examined and/or modified using _s_y_s_t_u_n_e(1).
  34.  
  35. EEEERRRRRRRROOOORRRRSSSS
  36.      _s_e_t_a_s_h may fail if one or more of these conditions are true:
  37.  
  38.      EEEEIIIINNNNVVVVAAAALLLL    _a_s_h is negative, in use by another array session on this
  39.                system, or in the range of values reserved by the system for
  40.                default array session handles.
  41.  
  42.      EEEEPPPPEEEERRRRMMMM     The current process does not have superuser privileges.
  43.  
  44. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  45.      systune(1), getash(2), newarraysess(2), array_sessions(5).
  46.  
  47. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  48.      Upon successful completion, _s_e_t_a_s_h returns a value of 0.  Otherwise, a
  49.      value of -1 is returned and eeeerrrrrrrrnnnnoooo is set to indicate the error.
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.